═══════════════════════════════════════════════════════════════
  KHAY ĐỌC RFID — BẢN CÀI SẴN (không cần cài Python)
  Vàng Bạc Thắng Hiếu
═══════════════════════════════════════════════════════════════

CHÉP CẢ THƯ MỤC NÀY vào máy cắm khay RFID (máy dưới quầy),
để ở chỗ cố định, ví dụ:  C:\KhayRFID\


─── CÀI 3 BƯỚC ────────────────────────────────────────────────

BƯỚC 1. Cắm khay RFID vào cổng USB của máy, đợi Windows nhận.

BƯỚC 2. Bấm đúp  "KHOI DONG KHAY RFID.bat"
        (bấm thẳng vào  KhayRFID.exe  cũng được, y như nhau)

        Lần đầu nó sẽ hỏi MÃ KẾT NỐI. Lấy mã như sau:
          • Mở app bằng tài khoản Giám đốc
          • Vào  Thêm → Thiết lập cửa hàng
          • Kéo xuống mục  📡 Khay đọc RFID
          • Bấm  "🔑 Xem mã kết nối agent"
          • Chép rồi dán vào cửa sổ đen, bấm Enter

        Chép cả khối chữ trong khung cũng được — máy tự lọc ra phần cần thiết.

        Hỏi tiếp địa chỉ máy chủ → cứ bấm Enter (đã điền sẵn đúng).

        ⚠️ Nếu Windows hiện bảng xanh "Windows protected your PC":
           bấm "More info" (Thông tin thêm) → "Run anyway" (Vẫn chạy).
           Đây là cảnh báo mặc định với phần mềm mới, không phải virus.

BƯỚC 3. Kiểm tra: vào lại  Thiết lập cửa hàng → 📡 Khay đọc RFID
        Phải thấy báo  "🟢 Khay đang kết nối".

        Đặt thử một món có gắn tem lên khay — số tem phải nhảy lên.


─── ĐỂ KHAY TỰ CHẠY MỖI KHI BẬT MÁY ──────────────────────────

Sau khi bước 2 chạy được rồi, chuột phải file
"CAI CHAY CUNG WINDOWS.bat" → chọn "Run as administrator".

Từ đó khay tự chạy ngầm, không hiện cửa sổ đen nữa.


─── MÁY KIỂM KHO CẦM TAY (nếu có) ────────────────────────────

Máy cầm tay NHR-10 nối bằng BLUETOOTH, không cắm dây. Nó dùng chung
với khay: quét được món nào thì lên app y như đặt lên khay.

  1. Bật máy cầm tay, để gần máy tính này
  2. Mở thư mục "Cong cu ky thuat" rồi bấm đúp "TIM MAY KIEM KHO CAM TAY.bat"
     để kiểm tra máy tính
     có nhận ra nó không
  3. Thấy rồi thì thôi — KhayRFID.exe tự kết nối mỗi khi chạy,
     không phải làm gì thêm

⚠️ Máy tính phải CÓ BLUETOOTH. Máy bàn thường không có sẵn — nếu
   file trên báo "máy tính này chưa có Bluetooth" thì mua thêm một
   USB Bluetooth 5.0 cắm vào là xong.

⚠️ Máy cầm tay chỉ hoạt động trong tầm Bluetooth của máy tính này
   (khoảng 10 mét, có tường thì gần hơn).


─── DÙNG HÀNG NGÀY ────────────────────────────────────────────

• Bán hàng:   đặt món lên khay → tự vào giỏ hàng trang Bán
• Gán tem:    Tồn kho → mở sản phẩm → gán tem RFID
• Kiểm kho:   bật "điểm danh bằng khay", đặt cả khay hàng lên
              (hoặc cầm máy NHR-10 quét quanh tủ)
• Tìm món:    Tồn kho → mở sản phẩm → "🔍 tìm bằng khay"


─── KHI CẬP NHẬT BẢN MỚI ─────────────────────────────────────

⚠️ PHẢI DỪNG KHAY TRƯỚC KHI GIẢI NÉN ĐÈ, không thì Windows báo
   "Folder In Use — The action can't be completed because the
   folder or a file in it is open in another program".

  1. Mở thư mục "Cong cu ky thuat" rồi bấm đúp "DUNG KHAY (truoc khi cap nhat).bat"
  2. Giải nén bản mới đè lên thư mục này
  3. Bấm đúp  "KhayRFID.exe"  để chạy lại

(Không cần nhập lại mã kết nối — file config.json được giữ nguyên.)


─── KHI TRỤC TRẶC ─────────────────────────────────────────────

Xem file  agent.log  nằm cùng thư mục này — dòng cuối ghi rõ lỗi.

• "Server tra 403"            → mã kết nối sai, xóa config.json rồi
                                chạy lại bước 2, lấy mã mới
• "Khong tim thay cong COM"   → khay chưa cắm chặt, hoặc rút ra cắm lại
• Không thấy gì trên app      → kiểm tra máy chủ có đang chạy không
• Máy cầm tay Bluetooth không kết nối được (dù đã bật + để gần), nhất là
  khi trước đó phải KHỞI ĐỘNG LẠI CẢ MÁY mới hết → mở "Cong cu ky thuat"
  → bấm "LAM MOI BLUETOOTH.bat" (làm mới riêng Bluetooth, ~15 giây, KHÔNG
  cần restart cả máy tính). Nếu công cụ báo không tự làm được, khởi động
  lại máy như cách cũ rồi báo lại kỹ thuật kèm ảnh danh sách thiết bị
  công cụ in ra.


─── LƯU Ý VỀ TEM TRÊN VÀNG ────────────────────────────────────

Tem RFID dán trực tiếp lên KIM LOẠI sẽ đọc kém hoặc không đọc
được (sóng bị phản xạ). Cách xử lý:
  • Dùng tem chuyên dụng cho kim loại (loại có lớp đệm chống nhiễu)
  • Hoặc dán tem lên phần nhãn giấy / hộp đựng, không dán thẳng
    lên mặt vàng
  • Đặt món nằm giữa khay, đừng để sát mép

Nếu đọc chập chờn: báo lại để chỉnh công suất ăng-ten và ngưỡng
tín hiệu trong Thiết lập cửa hàng.
